TEInsert

Insert text into an edit record

#include <TextEdit.h> TextEdit

void TEInsert(text, length, hTE );

Ptr text ; address of an array of characters

long length ; length, in bytes, of text to insert

TEHandle hTE ; handle of an edit record

TEInsert inserts the specified text immediately before the selection range or

insertion point. Use TEStylInsert to insert style-related information as

well as text.

text is the address of an array of characters to insert.

length is the amount of text, in characters, to be copied from text to the

edit record.

hTE is a handle obtained via TENew (old style TextEdit record) or

TEStylNew (new style TextEdit record). It leads to a

variable-length TERec structure and identifies the edit record to be

affected by this change.

Notes: This function can be used to store text into an edit record after

reading it from a file. It does not affect the scrap, so it may be useful in

implementing an "undo" feature.

Note that unlike TEPaste and TEKey, this does not replace the current

selection range. The selection range remains selected and highlighted and

the text is inserted in front of it.

Referenced by (15):